home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / sanautil.lha / sanautil.doc < prev    next >
Text File  |  1995-08-04  |  4KB  |  147 lines
  1.  
  2.  
  3.                               SANAutil
  4.                               --------
  5.  
  6.                         Version 0.38 (4.8.95)
  7.  
  8.                            by Timo Rossi
  9.  
  10.  
  11.  
  12. SANAutil is a testing/debugging tool for SANA2 network device drivers.
  13. It can be used to send/receive packets and display/change device status.
  14.  
  15. This document assumes that the reader is somewhat familiar with
  16. networking terminology and the SANA2 specification.
  17.  
  18. (The SANA2 specification (version 2) is available from
  19. Aminet, dev/misc/sana2_v2.lha)
  20.  
  21. Basic options:
  22.   -d <device_name> or DEVICE=<device_name>
  23.  
  24.     Sets the SANA2 device name. If not specified,
  25.     Sanautil reads the name from ENV:SANA2.Device,
  26.     and if that doesn't exists, it uses the default
  27.     "a2065.device".
  28.  
  29.   -u <unit_number> or UNIT=<unit_number>
  30.  
  31.     Sets the SANA2 device unit number. If not specified,
  32.     Sanautil reads it from ENV:SANA2.Unit, and if that
  33.     doesn't exist, the default is zero.
  34.  
  35.   -e or EXCLUSIVE
  36.  
  37.     Puts the SANA2 device in exclusive mode.
  38.     (Sets the SANA2IOF_MINE-flag on OpenDevice)
  39.  
  40.   -p or PROMISCUOUS
  41.  
  42.     Puts the SANA2 device in promiscuous mode.
  43.     (Sets the SANA2IOF_PROM-flag on OpenDevice)
  44.     This allows receiving packets that were not
  45.     not addressed to this machine. All SANA2
  46.     devices don't support this option.
  47.  
  48. Commands:
  49.  
  50.  SEND <addresss> [TYPE=<packet_type>] [LENGTH=<packet_length>] [DATA=<string>]
  51.  
  52.    This sends a packet to the specified address.
  53.    The format of the address is the normally used with Ethernet,
  54.    ie. hexadecimal numbers separated by colons
  55.    (for example 00:00:6E:10:86:33).
  56.  
  57.    The optional TYPE-parameter specifies the packet type
  58.    (decimal number). Default is 5000.
  59.  
  60.    The optional LENGTH-parameter specifies the length of the packet
  61.    to be send (not including headers). If not given, the default
  62.    is 100 bytes.
  63.  
  64.    The DATA-argument ca be used to fill the packet data with the given
  65.    string. If the packet is shorter than the data, extra data is ignored,
  66.    and if the packet is longer than the data, the packet is filled with
  67.    the data (repeating the string).
  68.    (Default data is "SANAUtil test packet -- ").
  69.  
  70.    Note that the device driver must be configured and online for
  71.    this to work (this command does not automatically try to
  72.    configure the device)
  73.  
  74.  MULTICAST <addresss> [TYPE=<packet_type>] [LENGTH=<packet_length>]
  75.            [DATA=<string>]
  76.  
  77.    Similar to SEND, but uses S2_MULTICAST command to send the packet.
  78.  
  79.  BROADCAST [TYPE=<packet_type>] [LENGTH=<packet_length>] [DATA=<string>]
  80.  
  81.    Similar to SEND, but uses BROADCAST (so no address argument is used).
  82.  
  83.  DUMP
  84.  
  85.    Displays received packets. Uses S2_READORPHAN, so it only
  86.    shows packets that are not requested by any other program/
  87.    protocol stack. This doesn't buffer the packets, so it
  88.    may only display a small amount of the actual network traffic.
  89.  
  90.    Note that the device driver must be configured and online for
  91.    this to work (this command does not automatically try to
  92.    configure the device)
  93.  
  94.   RECEIVE <packet_type>
  95.  
  96.    Similar to DUMP, but receives a specified packet type.
  97.    Depending on the device driver it may work even if there
  98.    is another program requesting the same packet type.
  99.  
  100.  STATUS
  101.  
  102.    Display SANA2 device status/address information.
  103.    (uses S2_DEVICEQUERY, S2_GETSTATIONADDRESS, S2_GETGLOBALSTATS
  104.    and S2_GETSPECIALSTATS to read the info from the device)
  105.  
  106.  CONFIG [ADDRESS=<address>]
  107.  
  108.    Configures the SANA2 device. If ADDRESS-parameter is not given,
  109.    uses the default address, otherwise uses the specified address.
  110.  
  111.  ONLINE, OFFLINE
  112.  
  113.    These commands put the SANA2 device in the Online/Offline state.
  114.  
  115.  ADDMULTICAST <address>
  116.  DELMULTICAST <address>
  117.  
  118.    These commands add and remove multicast addresses.
  119.  
  120.  TRACKTYPE <packettype>
  121.  UNTRACKTYPE <packetype>
  122.  
  123.    These commands add/remove the specified packet type
  124.    to/from the type tracking list.
  125.  
  126.  TYPESTAT <packettype>
  127.  
  128.    Shows the statisticks for <packettype>. Requires that
  129.    the type is currently being tracked.
  130.  
  131.  
  132.  
  133. SANAutil is copyright © 1992-1995 by Timo Rossi.
  134. It can be freely distributed for non-commercial purposes.
  135.  
  136.  
  137. Contact info for bug reports, suggestions etc.
  138. (E-Mail is preferred)
  139.  
  140.   Timo Rossi
  141.   Mattilankatu 40 A 4
  142.   40600 Jyväskylä
  143.   FINLAND
  144.  
  145. E-Mail: trossi@jyu.fi
  146.  
  147.